This is the documentation for the Realbasic Plugins from Monkeybreadsoftware.de. You find these plugins and the newest version of this document at http://www.monkeybreadsoftware.de/realbasic inside the plugins section.
This help was last updated on Freitag, 6. September 2002 and covers 2136 items: 126 classes, 2 controls and 583 global functions.
| The list of the themes | Global methods by category | Global methods by name | The list of the classes | The list of the controls |
class Resolution | ||||
| class, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
Defines a class for accessing the resolutions a screen. | ||||
Depth as integer | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
Depth of the resolution. | ||||
|
Notes:
Can be 8, 16 or 32. Other screen depths are not well supported. | ||||
displaynum as integer | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
DisplayNum is the number of the display | ||||
|
Notes:
The number is always between 0 and DisplayCount()-1, where 0 is the main monitor. | ||||
Height as integer | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
Height of the resolution. | ||||
hz as integer | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
frequency in Hz of that resolution | ||||
|
Notes:
Sometimes Hz is 0, this is when Windows itself does not know the frequency (at least it is so in my emulation, Virtual PC 3.0 with Win95). | ||||
issafe as boolean | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
Is it a safe resolution? | ||||
|
Notes:
On Mac OS X till now no resolution can be called safe. | ||||
Left as integer | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
The relative left offset to that resolution. | ||||
|
Notes:
Should be 0 for the main monitor. | ||||
ResolutionNum As Integer | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
DisplayNum is the number of the display. | ||||
|
Notes:
ResolutionNum is the number of the display which always is between 0 and GetDisplay(DisplayNum).ResolutionCount(false)-1. On Windows: dis.GetCurrentResolution.resolutionNum is sometimes also -1. | ||||
Switch As Boolean | ||||
| method, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
This function switches the display to the resolution and returns true if the attempt was successful. | ||||
|
Notes:
If IsSafe is false, show a dialog after the switch asking the user if that resolution is okay. If the user presses escape or clicks cancel, you should immediatly switch back to the old resolution. Especially on VGA-Monitors not all listed frequencies work. On Mac OS X till now no resolution can be called safe. | ||||
Top as integer | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
The relative top offset to the other monitors. | ||||
|
Notes:
Should be 0 for the main monitor. | ||||
Width as integer | ||||
| property, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Works. | ||
|
Function:
Width of this resolution. | ||||
ResolutionLibraryPresent as boolean | ||||
| global method, Resolution | So, 28. Apr 2002 | |||
| Mac OS Classic: Works. | Mac OS Carbon: Works. | Windows: Returns allways true | ||
|
Function:
Returns true if the DisplayManager library file was found. | ||||
|
Example:
if not ResolutionLibraryPresent then msgbox "I'm missing the shared library 'DisplayManager'." end if | ||||
|
Notes:
This library should be present on all Mac OS Classic versions. (It's in the system suitcase.) | ||||
Written 2002 by Christian Schmitz. Feel free to ask or report mistakes to realbasic@macsw.de.
Thanks.